

<!DOCTYPE html>
<html lang="zh-CN" data-default-color-scheme=auto>



<head>
  <meta charset="UTF-8">
  <!-- <link rel="manifest" href="/manifest.json"> -->
  <link rel="apple-touch-icon" sizes="76x76" href="/img/favicon.png">
  <link rel="icon" href="/img/favicon.png">
  <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0, shrink-to-fit=no">
  <meta http-equiv="x-ua-compatible" content="ie=edge">
  
  <meta name="theme-color" content="#2f4154">
  <meta name="author" content="阮一峰">
  <meta name="keywords" content="观清,博客,Blog,Hexo">
  
    <meta name="description" content="本文转载于阮一峰老师的《中文技术文档的写作规范》。">
<meta property="og:type" content="article">
<meta property="og:title" content="中文技术文档写作规范">
<meta property="og:url" content="https://jinghu-moon.top/posts/9113742/index.html">
<meta property="og:site_name" content="Guan Qing 的博客">
<meta property="og:description" content="本文转载于阮一峰老师的《中文技术文档的写作规范》。">
<meta property="og:locale" content="zh_CN">
<meta property="article:published_time" content="2022-01-13T13:26:03.000Z">
<meta property="article:modified_time" content="2022-02-24T02:50:40.699Z">
<meta property="article:author" content="观清">
<meta property="article:tag" content="写作规范">
<meta name="twitter:card" content="summary_large_image">
  
  
    <link href="https://fonts.loli.net/css2?family=Noto+Serif+SC:wght@400;500;600;700&display=swap" rel="stylesheet">
  
  <title>中文技术文档写作规范 - Guan Qing 的博客</title>

  <link  rel="stylesheet" href="https://cdn.staticfile.org/twitter-bootstrap/4.6.1/css/bootstrap.min.css" />


  <link  rel="stylesheet" href="https://cdn.staticfile.org/github-markdown-css/4.0.0/github-markdown.min.css" />
  <link  rel="stylesheet" href="https://cdn.staticfile.org/hint.css/2.7.0/hint.min.css" />

  
    
    
      
      <link  rel="stylesheet" href="https://cdn.staticfile.org/highlight.js/11.4.0/styles/github-gist.min.css" />
    
  

  
    <link  rel="stylesheet" href="https://cdn.staticfile.org/fancybox/3.5.7/jquery.fancybox.min.css" />
  


<!-- 主题依赖的图标库，不要自行修改 -->

<link rel="stylesheet" href="//at.alicdn.com/t/font_1749284_ba1fz6golrf.css">



<link rel="stylesheet" href="//at.alicdn.com/t/font_1736178_lbnruvf0jn.css">


<link  rel="stylesheet" href="/css/main.css" />

<!-- 自定义样式保持在最底部 -->

  
<link rel="stylesheet" href="/css/font.css">
<link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.15.4/css/all.css">
<link rel="stylesheet" href="//at.alicdn.com/t/font_2976433_iqbfcetntd.css">
<link rel="stylesheet" href="/css/ui.css">
<link rel="stylesheet" href="/css/code_folding.css">
<link rel="stylesheet" href="/css/code_folding_no_line.css">
<link rel="stylesheet" href="/css/translate_google.css">
<link rel="stylesheet" href="/css/notice.css">



  <script id="fluid-configs">
    var Fluid = window.Fluid || {};
    var CONFIG = {"hostname":"jinghu-moon.top","root":"/","version":"1.8.14","typing":{"enable":true,"typeSpeed":70,"cursorChar":"_","loop":false},"anchorjs":{"enable":true,"element":"h1,h2,h3,h4,h5,h6","placement":"right","visible":"hover","icon":""},"progressbar":{"enable":true,"height_px":3,"color":"#29d","options":{"showSpinner":false,"trickleSpeed":100}},"copy_btn":true,"image_zoom":{"enable":true,"img_url_replace":["",""]},"toc":{"enable":true,"headingSelector":"h1,h2,h3,h4,h5,h6","collapseDepth":0},"lazyload":{"enable":true,"loading_img":"/img/loading.gif","onlypost":false,"offset_factor":2},"web_analytics":{"enable":false,"baidu":null,"google":null,"gtag":null,"tencent":{"sid":null,"cid":null},"woyaola":null,"cnzz":null,"leancloud":{"app_id":"Hj9XxRfFahtxNYYkBG87h1Lb-gzGzoHsz","app_key":"hp4zQdF2mPCqhbRM9b3O4l2i","server_url":"https://hj9xxrff.lc-cn-n1-shared.com","path":"window.location.pathname","ignore_local":true}},"search_path":"/local-search.xml"};
  </script>
  <script  src="/js/utils.js" ></script>
  <script  src="/js/color-schema.js" ></script>
<meta name="generator" content="Hexo 6.0.0"></head>


<body>

  <header style="height: 80vh;">
    <nav id="navbar" class="navbar fixed-top  navbar-expand-lg navbar-dark scrolling-navbar">
  <div class="container">
    <a class="navbar-brand" href="/">
      <strong>Guan Qing 的博客</strong>
    </a>

    <button id="navbar-toggler-btn" class="navbar-toggler" type="button" data-toggle="collapse"
            data-target="#navbarSupportedContent"
            aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
      <div class="animated-icon"><span></span><span></span><span></span></div>
    </button>

    <!-- Collapsible content -->
    <div class="collapse navbar-collapse" id="navbarSupportedContent">
      <ul class="navbar-nav ml-auto text-center">
        
          
          
          
          
            <li class="nav-item">
              <a class="nav-link" href="/">
                <i class="iconfont icon-home-fill"></i>
                首页
              </a>
            </li>
          
        
          
          
          
          
            <li class="nav-item dropdown">
              <a class="nav-link dropdown-toggle" target="_self" href="javascript:;" role="button"
                 data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
                <i class="iconfont icon-books"></i>
                文章
              </a>
              <div class="dropdown-menu" aria-labelledby="navbarDropdown">
                
                  
                  
                  
                  <a class="dropdown-item" href="/archives/">
                    <i class="iconfont icon-archive-fill"></i>
                    归档
                  </a>
                
                  
                  
                  
                  <a class="dropdown-item" href="/categories/">
                    <i class="iconfont icon-category-fill"></i>
                    分类
                  </a>
                
                  
                  
                  
                  <a class="dropdown-item" href="/tags/">
                    <i class="iconfont icon-biaoqian1"></i>
                    标签
                  </a>
                
                  
                  
                  
                  <a class="dropdown-item" href="/random">
                    <i class="iconfont icon-manyou2"></i>
                    漫游
                  </a>
                
              </div>
            </li>
          
        
          
          
          
          
            <li class="nav-item">
              <a class="nav-link" href="/talking/">
                <i class="iconfont icon-liaotian"></i>
                说说
              </a>
            </li>
          
        
          
          
          
          
            <li class="nav-item dropdown">
              <a class="nav-link dropdown-toggle" target="_self" href="javascript:;" role="button"
                 data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
                <i class="iconfont icon-16gf-bookmarks2"></i>
                收藏
              </a>
              <div class="dropdown-menu" aria-labelledby="navbarDropdown">
                
                  
                  
                  
                  <a class="dropdown-item" href="/stars/">
                    <i class="iconfont icon-shoucang"></i>
                    书签
                  </a>
                
                  
                  
                  
                  <a class="dropdown-item" href="/nav/">
                    <i class="iconfont icon-shoucangjia"></i>
                    导航
                  </a>
                
                  
                  
                  
                  <a class="dropdown-item" target="_blank" rel="noopener external nofollow noreferrer" href="https://guanqing.netlify.app/admin">
                    <i class="iconfont icon-houtaiguanli"></i>
                    后台
                  </a>
                
                  
                  
                  
                  <a class="dropdown-item" target="_blank" rel="noopener external nofollow noreferrer" href="https://github-quick.jinghu-moon.workers.dev/">
                    <i class="iconfont icon-rocket"></i>
                    GitHub 文件加速
                  </a>
                
              </div>
            </li>
          
        
          
          
          
          
            <li class="nav-item">
              <a class="nav-link" href="/about/">
                <i class="iconfont icon-user-fill"></i>
                关于
              </a>
            </li>
          
        
          
          
          
          
            <li class="nav-item">
              <a class="nav-link" href="/links/">
                <i class="iconfont icon-link-fill"></i>
                友链
              </a>
            </li>
          
        
        
          <li class="nav-item" id="search-btn">
            <a class="nav-link" target="_self" href="javascript:;" rel="external nofollow noreferrer" data-toggle="modal" data-target="#modalSearch" aria-label="Search">
              &nbsp;<i class="iconfont icon-search"></i>&nbsp;
            </a>
          </li>
        
        
          <li class="nav-item" id="color-toggle-btn">
            <a class="nav-link" target="_self" href="javascript:;" rel="external nofollow noreferrer" aria-label="Color Toggle">&nbsp;<i
                class="iconfont icon-dark" id="color-toggle-icon"></i>&nbsp;</a>
          </li>
        
      </ul>
    </div>
  </div>
</nav>

    <div class="banner" id="banner" parallax=true
        style="background: url('/img/default.png') no-repeat center center;
          background-size: cover;">
      <div class="full-bg-img">
        <div class="mask flex-center" style="background-color: rgba(0, 0, 0, 0.3)">
          <div class="page-header text-center fade-in-up">
            <span class="h2" id="subtitle" title="中文技术文档写作规范">
              
            </span>
<!-- 添加的代码 -->
<!-- ========================================================================= -->
            
<!-- ========================================================================= -->

            
              <div class="mt-3">
  
  
    <span class="post-meta">
      <i class="iconfont icon-date-fill" aria-hidden="true"></i>
      <time datetime="2022-01-13 21:26" pubdate>
        2022年1月13日 晚上
      </time>
    </span>
  
</div>

<div class="mt-1">
  
    <span class="post-meta mr-2">
      <i class="iconfont icon-chart"></i>
      6.1k 字
    </span>
  

  
    <span class="post-meta mr-2">
      <i class="iconfont icon-clock-fill"></i>
      
      
      52 分钟
    </span>
  

  
  
</div>

            
          </div>

          
            <div class="scroll-down-bar">
              <i class="iconfont icon-arrowdown"></i>
            </div>
          
        </div>
      </div>
    </div>
  </header>

  <main>
    
      

<div class="container-fluid nopadding-x">
  <div class="row nomargin-x">
    <div class="d-none d-lg-block col-lg-2"></div>
    <div class="col-lg-8 nopadding-x-md">
      <div class="container nopadding-x-md" id="board-ctn">
        <div class="py-5" id="board">
          <article class="post-content mx-auto">
            <!-- SEO header -->
            <h1 style="display: none">中文技术文档写作规范</h1>
            
              <p class="note note-info">
                
                  本文最后更新于：2022年2月24日 上午
                
              </p>
            
            <div class="markdown-body">
              <p>本文链接： <a target="_blank" rel="noopener external nofollow noreferrer" href="https://github.com/ruanyf/document-style-guide">ruanyf&#x2F;document-style-guide: 中文技术文档的写作规范 (github.com)</a> 。</p>
<p>为方便阅读，对文章的排版做了修改。内容未做改动。</p>
<h1 id="第一章-标题"><a href="#第一章-标题" class="headerlink" title="第一章    标题"></a>第一章    标题</h1><h2 id="1-1-层级"><a href="#1-1-层级" class="headerlink" title="1.1 层级"></a>1.1 层级</h2><p>标题分为四级。</p>
<ul>
<li>一级标题：文章的标题</li>
<li>二级标题：文章主要部分的大标题</li>
<li>三级标题：二级标题下面一级的小标题</li>
<li>四级标题：三级标题下面某一方面的小标题</li>
</ul>
<p>下面是示例。</p>
<div class="code-wrapper"><pre><code class="hljs markdown"><span class="hljs-section"># 一级标题</span>

<span class="hljs-section">## 二级标题</span>

<span class="hljs-section">### 三级标题</span>

<span class="hljs-section">#### 四级标题</span></code></pre></div>

<h2 id="1-2-原则"><a href="#1-2-原则" class="headerlink" title="1.2 原则"></a>1.2 原则</h2><p>（1）一级标题下，不能直接出现三级标题。</p>
<p>示例：下面的文章结构，缺少二级标题。</p>
<div class="code-wrapper"><pre><code class="hljs markdown"><span class="hljs-section"># 一级标题</span>

<span class="hljs-section">### 三级标题</span></code></pre></div>

<p>（2）标题要避免孤立编号（即同级标题只有一个）。</p>
<p>示例：下面的文章结构，<code>二级标题 A</code>只包含一个三级标题，完全可以省略<code>三级标题 A</code>。</p>
<div class="code-wrapper"><pre><code class="hljs markdown"><span class="hljs-section">## 二级标题 A</span>

<span class="hljs-section">### 三级标题 A</span>

<span class="hljs-section">## 二级标题 B</span></code></pre></div>

<p>（3）下级标题不重复上一级标题的名字。</p>
<p>示例：下面的文章结构，二级标题与下属的三级标题同名，建议避免。</p>
<div class="code-wrapper"><pre><code class="hljs markdown"><span class="hljs-section">## 概述</span>

<span class="hljs-section">### 概述</span></code></pre></div>

<p>（4）谨慎使用四级标题，尽量避免出现，保持层级的简单，防止出现过于复杂的章节。</p>
<p>如果三级标题下有并列性的内容，建议只使用项目列表（Item list）。</p>
<p>示例：下面的结构二要好于结构一。结构一适用的场景，主要是较长篇幅的内容。</p>
<div class="code-wrapper"><pre><code class="hljs markdown">结构一

<span class="hljs-section">### 三级标题</span>

<span class="hljs-section">#### 四级标题 A</span>

<span class="hljs-section">#### 四级标题 B</span>

<span class="hljs-section">#### 四级标题 C</span>

结构二

<span class="hljs-section">### 三级标题</span>

<span class="hljs-strong">**（1）A**</span>

<span class="hljs-strong">**（2）B**</span>

<span class="hljs-strong">**（3）C**</span></code></pre></div>

<h1 id="第二章-文本"><a href="#第二章-文本" class="headerlink" title="第二章    文本"></a>第二章    文本</h1><h2 id="2-1-字间距"><a href="#2-1-字间距" class="headerlink" title="2.1 字间距"></a>2.1 字间距</h2><p>（1）全角中文字符与半角英文字符之间，应有一个半角空格。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：本文介绍如何快速启动Windows系统。

正确：本文介绍如何快速启动 Windows 系统。</code></pre></div>

<p>（2）全角中文字符与半角阿拉伯数字之间，有没有半角空格都可，但必须保证风格统一，不能两种风格混杂。</p>
<div class="code-wrapper"><pre><code class="hljs tap">正确：2011年5月15日，我订购了5台笔记本电脑与10台平板电脑。

正确：2011 年<span class="hljs-number"> 5 </span>月<span class="hljs-number"> 15 </span>日，我订购了<span class="hljs-number"> 5 </span>台笔记本电脑与<span class="hljs-number"> 10 </span>台平板电脑。</code></pre></div>

<p>半角的百分号，视同阿拉伯数字。</p>
<div class="code-wrapper"><pre><code class="hljs erlang-repl">正确：今年我国经济增长率是<span class="hljs-number">6.5</span><span class="hljs-comment">%。</span>

正确：今年我国经济增长率是 <span class="hljs-number">6.5</span><span class="hljs-comment">%。</span></code></pre></div>

<p>（3）英文单位若不翻译，单位前的阿拉伯数字与单位符号之间，应留出适当的空隙。</p>
<div class="code-wrapper"><pre><code class="hljs nix">例<span class="hljs-number">1</span>：一部容量为 <span class="hljs-number">16</span> GB 的智能手机

例<span class="hljs-number">2</span>：<span class="hljs-number">1</span> <span class="hljs-attr">h</span> = <span class="hljs-number">60</span> <span class="hljs-attr">min</span> = <span class="hljs-number">3</span>,<span class="hljs-number">600</span> s</code></pre></div>

<p>（4）半角英文字符和半角阿拉伯数字，与全角标点符号之间不留空格。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：他的电脑是 MacBook Air 。

正确：他的电脑是 MacBook Air。</code></pre></div>

<h2 id="2-2-句子"><a href="#2-2-句子" class="headerlink" title="2.2 句子"></a>2.2 句子</h2><p>（1）避免使用长句。</p>
<p>不包含任何标点符号的单个句子，或者以逗号分隔的句子构件，长度尽量保持在 20 个字以内；20～29 个字的句子，可以接受；30～39 个字的句子，语义必须明确，才能接受；多于 40 个字的句子，任何情况下都不能接受。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：本产品适用于从由一台服务器进行动作控制的单一节点结构到由多台服务器进行动作控制的并行处理程序结构等多种体系结构。

正确：本产品适用于多种体系结构。无论是由一台服务器（单一节点结构），还是由多台服务器（并行处理结构）进行动作控制，均可以使用本产品。</code></pre></div>

<p>逗号分割的长句，总长度不应该超过 100 字或者正文的 3 行。</p>
<p>（2）尽量使用简单句和并列句，避免使用复合句。</p>
<div class="code-wrapper"><pre><code class="hljs">并列句：他昨天生病了，没有参加会议。

复合句：那个昨天生病的人没有参加会议。</code></pre></div>

<p>（3）同样一个意思，尽量使用肯定句表达，不使用否定句表达。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：请确认没有接通装置的电源。

正确：请确认装置的电源已关闭。</code></pre></div>

<p>（4）避免使用双重否定句。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：没有删除权限的用户，不能删除此文件。

正确：用户必须拥有删除权限，才能删除此文件。</code></pre></div>

<h2 id="2-3-写作风格"><a href="#2-3-写作风格" class="headerlink" title="2.3 写作风格"></a>2.3 写作风格</h2><p>（1）尽量不使用被动语态，改为使用主动语态。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：假如此软件尚未被安装，

正确：假如尚未安装这个软件，</code></pre></div>

<p>（2）不使用非正式的语言风格。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：Lady Gaga 的演唱会真是酷毙了，从没看过这么给力的表演！！！

正确：无法参加本次活动，我深感遗憾。</code></pre></div>

<p>（3）不使用冷僻、生造或者文言文的词语，而要使用现代汉语的常用表达方式。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：这是唯二的快速启动的方法。

正确：这是仅有的两种快速启动的方法。</code></pre></div>

<p>（4）用对“的”、“地”、“得”。</p>
<div class="code-wrapper"><pre><code class="hljs">她露出了开心的笑容。
（形容词＋的＋名词）

她开心地笑了。
（副词＋地＋动词）

她笑得很开心。
（动词＋得＋副词）</code></pre></div>

<p>（5）使用代词时（比如“其”、“该”、“此”、“这”等词），必须明确指代的内容，保证只有一个含义。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：从管理系统可以监视中继系统和受其直接控制的分配系统。

正确：从管理系统可以监视两个系统：中继系统和受中继系统直接控制的分配系统。</code></pre></div>

<p>（6）名词前不要使用过多的形容词。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：此设备的使用必须在接受过本公司举办的正式的设备培训的技师的指导下进行。

正确：此设备必须在技师的指导下使用，且指导技师必须接受过由本公司举办的正式设备培训。</code></pre></div>

<h2 id="2-4-英文处理"><a href="#2-4-英文处理" class="headerlink" title="2.4 英文处理"></a>2.4 英文处理</h2><p>（1）英文原文如果使用了复数形式，翻译成中文时，应该将其还原为单数形式。</p>
<div class="code-wrapper"><pre><code class="hljs ada">英文：⋯information stored <span class="hljs-keyword">in</span> random <span class="hljs-keyword">access</span> memory (RAMs)⋯

中文：……存储在随机存取存储器（RAM）里的信息……</code></pre></div>

<p>（2）外文缩写可以使用半角圆点(<code>.</code>)表示缩写。</p>
<div class="code-wrapper"><pre><code class="hljs erlang">U.S.A.
Apple, Inc.</code></pre></div>

<p>（3）表示中文时，英文省略号（<code>⋯</code>）应改为中文省略号（<code>……</code>）。</p>
<div class="code-wrapper"><pre><code class="hljs vim">英文：<span class="hljs-number">5</span> minutes <span class="hljs-keyword">later</span>⋯

中文：<span class="hljs-number">5</span> 分钟过去了……</code></pre></div>

<p>（4）英文书名或电影名改用中文表达时，双引号应改为书名号。</p>
<div class="code-wrapper"><pre><code class="hljs stata">英文：<span class="hljs-keyword">He</span> published <span class="hljs-keyword">an</span> article entitled <span class="hljs-string">&quot;The Future of the Aviation&quot;</span>.

中文：他发表了一篇名为《航空业的未来》的文章。</code></pre></div>

<p>（5）第一次出现英文词汇时，在括号中给出中文标注。此后再次出现时，直接使用英文缩写即可。</p>
<div class="code-wrapper"><pre><code class="hljs">IOC（International Olympic Committee，国际奥林匹克委员会）。这样定义后，便可以直接使用“IOC”了。</code></pre></div>

<p>（6）专有名词中每个词第一个字母均应大写，非专有名词则不需要大写。</p>
<div class="code-wrapper"><pre><code class="hljs applescript">“American Association <span class="hljs-keyword">of</span> Physicists <span class="hljs-keyword">in</span> Medicine”（美国医学物理学家协会）是专有名词，需要大写。

“online <span class="hljs-keyword">transaction</span> processing”（在线事务处理）不是专有名词，不应大写。</code></pre></div>

<h1 id="第三章-段落"><a href="#第三章-段落" class="headerlink" title="第三章    段落"></a>第三章    段落</h1><h2 id="3-1-原则"><a href="#3-1-原则" class="headerlink" title="3.1 原则"></a>3.1 原则</h2><ul>
<li>一个段落只能有一个主题，或一个中心句子。</li>
<li>段落的中心句子放在段首，对全段内容进行概述。后面陈述的句子为核心句服务。</li>
<li>一个段落的长度不能超过七行，最佳段落长度小于等于四行。</li>
<li>段落的句子语气要使用陈述和肯定语气，避免使用感叹语气。</li>
<li>段落之间使用一个空行隔开。</li>
<li>段落开头不要留出空白字符。</li>
</ul>
<h2 id="3-2-引用"><a href="#3-2-引用" class="headerlink" title="3.2 引用"></a>3.2 引用</h2><p>引用第三方内容时，应注明出处。</p>
<div class="code-wrapper"><pre><code class="hljs inform7">One <span class="hljs-keyword">man</span>’s constant <span class="hljs-keyword">is</span> another <span class="hljs-keyword">man</span>’s variable. — Alan Perlis</code></pre></div>

<p>如果是全篇转载，请在全文开头显著位置注明作者和出处，并链接至原文。</p>
<div class="code-wrapper"><pre><code class="hljs">本文转载自 WikiQuote</code></pre></div>

<p>使用外部图片时，必须在图片下方或文末标明来源。</p>
<div class="code-wrapper"><pre><code class="hljs">本文部分图片来自 Wikipedia</code></pre></div>

<h1 id="第四章-数值"><a href="#第四章-数值" class="headerlink" title="第四章    数值"></a>第四章    数值</h1><h2 id="4-1-半角数字"><a href="#4-1-半角数字" class="headerlink" title="4.1 半角数字"></a>4.1 半角数字</h2><p>阿拉伯数字一律使用半角形式，不得使用全角形式。</p>
<div class="code-wrapper"><pre><code class="hljs yaml"><span class="hljs-string">错误：这件商品的价格是１０００元。</span>

<span class="hljs-string">正确：这件商品的价格是</span> <span class="hljs-number">1000</span> <span class="hljs-string">元。</span></code></pre></div>

<h2 id="4-2-千分号"><a href="#4-2-千分号" class="headerlink" title="4.2 千分号"></a>4.2 千分号</h2><p>数值为千位以上，应添加千分号（半角逗号）。</p>
<div class="code-wrapper"><pre><code class="hljs apache"><span class="hljs-attribute">XXX</span> 公司的实收资本为 ￥<span class="hljs-number">1</span>,<span class="hljs-number">258</span>,<span class="hljs-number">000</span> 人民币。</code></pre></div>

<p>对于 4 位的数值，千分号是选用的，比如<code>1000</code>和<code>1,000</code>都可以接受。对于 4 位以上的数值，应添加千分号。</p>
<h2 id="4-3-货币"><a href="#4-3-货币" class="headerlink" title="4.3 货币"></a>4.3 货币</h2><p>货币应为阿拉伯数字，并在数字前写出货币符号，或在数字后写出货币中文名称。</p>
<div class="code-wrapper"><pre><code class="hljs gams"><span class="hljs-meta"><span class="hljs-keyword">$1</span>,000</span>
<span class="hljs-number">1</span>,<span class="hljs-number">000</span> 美元</code></pre></div>

<p>英文的货币名称，建议参考国际标准 <a target="_blank" rel="noopener external nofollow noreferrer" href="https://en.wikipedia.org/wiki/ISO_4217">ISO 4217</a>。</p>
<h2 id="4-4-数值范围"><a href="#4-4-数值范围" class="headerlink" title="4.4 数值范围"></a>4.4 数值范围</h2><p>表示数值范围时，用波浪线（<code>～</code>）或一字线（<code>—</code>）连接。参见《标点符号》一节的“连接号”部分。</p>
<p>带有单位或百分号时，两个数字建议都要加上单位或百分号。</p>
<div class="code-wrapper"><pre><code class="hljs basic"><span class="hljs-symbol">132 </span>kg～<span class="hljs-number">234</span> kg

<span class="hljs-number">67</span>%～<span class="hljs-number">89</span>%</code></pre></div>

<h2 id="4-5-变化程度的表示法"><a href="#4-5-变化程度的表示法" class="headerlink" title="4.5 变化程度的表示法"></a>4.5 变化程度的表示法</h2><p>数字的增加要使用“增加了”、“增加到”。“了”表示增量，“到”表示定量。</p>
<div class="code-wrapper"><pre><code class="hljs">增加到过去的两倍
（过去为一，现在为二）

增加了两倍
（过去为一，现在为三）</code></pre></div>

<p>数字的减少要使用“降低了”、“降低到”。“了”表示增量，“到”表示定量。</p>
<div class="code-wrapper"><pre><code class="hljs">降低到百分之八十
（定额是一百，现在是八十）

降低了百分之八十
（原来是一百，现在是二十）</code></pre></div>

<p>不能用“降低 N 倍”或“减少 N 倍”的表示法，要用“降低百分之几”或“减少百分之几”。因为减少（或降低）一倍表示数值原来为一百，现在等于零。</p>
<h1 id="第五章-标点符号"><a href="#第五章-标点符号" class="headerlink" title="第五章    标点符号"></a>第五章    标点符号</h1><h2 id="5-1-原则"><a href="#5-1-原则" class="headerlink" title="5.1 原则"></a>5.1 原则</h2><p>（1）中文语句的标点符号，均应该采取全角符号，这样可以与全角文字保持视觉的一致。</p>
<p>（2）如果整句为英文，则该句使用英文&#x2F;半角标点。</p>
<p>（3）句号、问号、叹号、逗号、顿号、分号和冒号不得出现在一行之首。</p>
<p>（4）点号（句号、逗号、顿号、分号、冒号）不得出现在标题的末尾，而标号（引号、括号、破折号、省略号、书名号、着重号、间隔号、叹号、问号）可以。</p>
<h2 id="5-2-句号"><a href="#5-2-句号" class="headerlink" title="5.2 句号"></a>5.2 句号</h2><p>（1）中文语句的结尾处应该用全角句号（<code>。</code>）。</p>
<p>（2）句子末尾用括号加注时，句号应在括号之外。</p>
<div class="code-wrapper"><pre><code class="hljs tap">错误：关于文件的输出，请参照第 1.3 节（见第<span class="hljs-number"> 26 </span>页。）

正确：关于文件的输出，请参照第 1.3 节（见第<span class="hljs-number"> 26 </span>页）。</code></pre></div>

<h2 id="5-3逗号"><a href="#5-3逗号" class="headerlink" title="5.3逗号"></a>5.3逗号</h2><p>（1）逗号（<code>，</code>）表示句子内部的一般性停顿。</p>
<p>（2）注意避免“一逗到底”，即整个段落除了结尾，全部停顿都使用逗号。</p>
<h2 id="5-4-顿号"><a href="#5-4-顿号" class="headerlink" title="5.4 顿号"></a>5.4 顿号</h2><p>（1）句子内部的并列词，应该用全角顿号(<code>、</code>) 分隔，而不用逗号，即使并列词是英语也是如此。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：我最欣赏的科技公司有 Google, Facebook, 腾讯, 阿里和百度等。

正确：我最欣赏的科技公司有 Google、Facebook、腾讯、阿里和百度等。</code></pre></div>

<p>（2）英文句子中，并列词语之间使用半角逗号（<code>,</code>）分隔。</p>
<div class="code-wrapper"><pre><code class="hljs arcade">例句：Microsoft Office <span class="hljs-built_in">includes</span> Word, Excel, PowerPoint, Outlook and other components.</code></pre></div>

<p>（3）中文句子内部的并列词，最后一个尽量使用（<code>和</code>）来连接，使句子读起来更加连贯，下面两个句子都可以，第二个更优。</p>
<div class="code-wrapper"><pre><code class="hljs">正确：我最欣赏的科技公司有 Google、Facebook、腾讯、阿里，以及百度等。

正确：我最欣赏的科技公司有 Google、Facebook、腾讯、阿里和百度等。</code></pre></div>

<h2 id="5-5-分号"><a href="#5-5-分号" class="headerlink" title="5.5 分号"></a>5.5 分号</h2><p>（1）分号（<code>；</code>）表示复句内部并列分句之间的停顿。</p>
<h2 id="5-6-引号"><a href="#5-6-引号" class="headerlink" title="5.6 引号"></a>5.6 引号</h2><p>（1）引用时，应该使用全角双引号（<code>“ ”</code>），注意前后双引号不同。</p>
<div class="code-wrapper"><pre><code class="hljs">例句：许多人都认为客户服务的核心是“友好”和“专业”。</code></pre></div>

<p>（2）引号里面还要用引号时，外面一层用双引号，里面一层用单引号（<code>‘ ’</code>），注意前后单引号不同。</p>
<div class="code-wrapper"><pre><code class="hljs">例句：鲍勃解释道：“我要放音乐，可萨利说，‘不行！’。”</code></pre></div>

<h2 id="5-7-括号"><a href="#5-7-括号" class="headerlink" title="5.7 括号"></a>5.7 括号</h2><p>（1）补充说明时，使用全角圆括号（<code>（）</code>），括号前后不加空格。</p>
<div class="code-wrapper"><pre><code class="hljs">例句：请确认所有的连接（电缆和接插件）均安装牢固。</code></pre></div>

<p>（2）几种括号的中英文名称。</p>
<table>
<thead>
<tr>
<th></th>
<th align="center">英文</th>
<th align="center">中文</th>
</tr>
</thead>
<tbody><tr>
<td><code>&#123; &#125;</code></td>
<td align="center">braces 或 curly brackets</td>
<td align="center">大括号</td>
</tr>
<tr>
<td><code>[ ]</code></td>
<td align="center">square brackets 或 brackets</td>
<td align="center">方括号</td>
</tr>
<tr>
<td><code>&lt; &gt;</code></td>
<td align="center">angled brackets</td>
<td align="center">尖括号</td>
</tr>
<tr>
<td><code>( )</code></td>
<td align="center">parentheses</td>
<td align="center">圆括号</td>
</tr>
</tbody></table>
<h2 id="5-8-冒号"><a href="#5-8-冒号" class="headerlink" title="5.8 冒号"></a>5.8 冒号</h2><p>（1）全角冒号（<code>：</code>）常用在需要解释的词语后边，引出解释和说明。</p>
<div class="code-wrapper"><pre><code class="hljs">例句：请确认以下几项内容：时间、地点、活动名称和来宾数量。</code></pre></div>

<p>（2）表示时间时，应使用半角冒号（<code>:</code>）。</p>
<div class="code-wrapper"><pre><code class="hljs">例句：早上 8:00</code></pre></div>

<h2 id="5-9-省略号"><a href="#5-9-省略号" class="headerlink" title="5.9 省略号"></a>5.9 省略号</h2><p>（1）省略号（<code>……</code>）表示语句未完、或者语气的不连续。</p>
<p>（2）省略号占两个汉字空间、包含六个省略点，不要使用<code>。。。</code>或<code>...</code>等非标准形式。</p>
<p>（3）省略号不应与“等”这个词一起使用。</p>
<div class="code-wrapper"><pre><code class="hljs">错误：我们为会餐准备了香蕉、苹果、梨…等各色水果。

正确：我们为会餐准备了各色水果，有香蕉、苹果、梨……

正确：我们为会餐准备了香蕉、苹果、梨等各色水果。</code></pre></div>

<h2 id="5-10-感叹号"><a href="#5-10-感叹号" class="headerlink" title="5.10 感叹号"></a>5.10 感叹号</h2><p>（1）应该使用平静的语气叙述，尽量避免使用感叹号（<code>！</code>）。</p>
<p>（2）不得多个感叹号连用，比如<code>！！</code>和<code>!!!</code>。</p>
<h2 id="5-11-破折号"><a href="#5-11-破折号" class="headerlink" title="5.11 破折号"></a>5.11 破折号</h2><p>（1）破折号<code>————</code>一般用于进一步解释。</p>
<p>（2）破折号应占两个汉字的位置。如果破折号本身只占一个汉字的位置，那么前后应该留出一个半角空格。</p>
<div class="code-wrapper"><pre><code class="hljs">例句：直觉————尽管它并不总是可靠的————告诉我，这事可能出了些问题。

例句：直觉 —— 尽管它并不总是可靠的 —— 告诉我，这事可能出了些问题。</code></pre></div>

<h2 id="5-12-连接号"><a href="#5-12-连接号" class="headerlink" title="5.12 连接号"></a>5.12 连接号</h2><p>（1）连接号用于连接两个类似的词。</p>
<p>（2）以下场合应该使用直线连接号（<code>-</code>），占一个半角字符的位置。</p>
<ul>
<li>两个名词的复合</li>
<li>图表编号</li>
</ul>
<div class="code-wrapper"><pre><code class="hljs subunit">例句：氧化-还原反应

例句：图 1<span class="hljs-string">-1</span></code></pre></div>

<p>（3）数值范围（例如日期、时间或数字）应该使用波浪连接号（<code>～</code>）或一字号（<code>—</code>），占一个全角字符的位置。</p>
<div class="code-wrapper"><pre><code class="hljs">例句：2009 年～2011 年</code></pre></div>

<p>注意，波浪连接号前后两个值都建议加上单位。</p>
<p>（4）波浪连接号也可以用汉字“至”代替。</p>
<div class="code-wrapper"><pre><code class="hljs mathematica">例句：周围温度：<span class="hljs-operator">-</span><span class="hljs-number">20</span> °<span class="hljs-built_in">C</span> 至 <span class="hljs-operator">-</span><span class="hljs-number">10</span> °<span class="hljs-built_in">C</span></code></pre></div>

<h1 id="第六章-文档体系"><a href="#第六章-文档体系" class="headerlink" title="第六章    文档体系"></a>第六章    文档体系</h1><h2 id="6-1-结构"><a href="#6-1-结构" class="headerlink" title="6.1 结构"></a>6.1 结构</h2><p>软件手册是一部完整的书，建议采用下面的结构。</p>
<ul>
<li><strong>简介</strong>（Introduction）： [必备] [文件] 提供对产品和文档本身的总体的、扼要的说明</li>
<li><strong>快速上手</strong>（Getting Started）：[可选] [文件] 如何最快速地使用产品</li>
<li><strong>入门篇</strong>（Basics）： [必备] [目录] 又称”使用篇“，提供初级的使用教程<ul>
<li><strong>环境准备</strong>（Prerequisite）：[必备] [文件] 软件使用需要满足的前置条件</li>
<li><strong>安装</strong>（Installation）：[可选] [文件] 软件的安装方法</li>
<li><strong>设置</strong>（Configuration）：[必备] [文件] 软件的设置</li>
</ul>
</li>
<li><strong>进阶篇</strong>（Advanced)：[可选] [目录] 又称”开发篇“，提供中高级的开发教程</li>
<li><strong>API</strong>（Reference）：[可选] [目录|文件] 软件 API 的逐一介绍</li>
<li><strong>FAQ</strong>：[可选] [文件] 常见问题解答</li>
<li><strong>附录</strong>（Appendix）：[可选] [目录] 不属于教程本身、但对阅读教程有帮助的内容<ul>
<li><strong>Glossary</strong>：[可选] [文件] 名词解释</li>
<li><strong>Recipes</strong>：[可选] [文件] 最佳实践</li>
<li><strong>Troubleshooting</strong>：[可选] [文件] 故障处理</li>
<li><strong>ChangeLog</strong>：[可选] [文件] 版本说明</li>
<li><strong>Feedback</strong>：[可选] [文件] 反馈方式</li>
</ul>
</li>
</ul>
<p>下面是两个真实范例，可参考。</p>
<ul>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="https://redux.js.org/introduction/getting-started">Redux 手册</a></li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="http://flight-manual.atom.io/">Atom 手册</a></li>
</ul>
<h2 id="6-2-文件名"><a href="#6-2-文件名" class="headerlink" title="6.2 文件名"></a>6.2 文件名</h2><p>文档的文件名不得含有空格。</p>
<p>文件名必须使用半角字符，不得使用全角字符。这也意味着，中文不能用于文件名。</p>
<div class="code-wrapper"><pre><code class="hljs dos">错误：名词解释.<span class="hljs-built_in">md</span>

正确：glossary.<span class="hljs-built_in">md</span></code></pre></div>

<p>文件名建议只使用小写字母，不使用大写字母。</p>
<div class="code-wrapper"><pre><code class="hljs dos">错误：TroubleShooting.<span class="hljs-built_in">md</span>

正确：troubleshooting.<span class="hljs-built_in">md</span></code></pre></div>

<p>为了醒目，某些说明文件的文件名，可以使用大写字母，比如<code>README</code>、<code>LICENSE</code>。</p>
<p>文件名包含多个单词时，单词之间建议使用半角的连词线（<code>-</code>）分隔。</p>
<div class="code-wrapper"><pre><code class="hljs dos">不佳：advanced_usage.<span class="hljs-built_in">md</span>

正确：advanced-usage.<span class="hljs-built_in">md</span></code></pre></div>

<h1 id="参考链接"><a href="#参考链接" class="headerlink" title="参考链接"></a>参考链接</h1><ul>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="http://wenku.baidu.com/view/23cc1a6527d3240c8447efbf.html">产品手册中文写作规范</a>, by 华为</li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="http://guide.daocloud.io/dcs/%E5%86%99%E4%BD%9C%E8%A7%84%E8%8C%83%E5%92%8C%E6%A0%BC%E5%BC%8F%E8%A7%84%E8%8C%83-9153803.html">写作规范和格式规范</a>, by DaoCloud</li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="http://www.hitachi-tc.co.jp/company/thesis/thesis.pdf">技术写作技巧在日汉翻译中的应用</a>, by 刘方</li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="https://www.lengoo.de/documents/styleguides/lengoo_styleguide_ZH.pdf">简体中文规范指南</a>, by lengoo</li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="https://open.leancloud.cn/copywriting-style-guide.html">文档风格指南</a>, by LeanCloud</li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="https://docs.google.com/document/d/1R8lMCPf6zCD5KEA8ekZ5knK77iw9J-vJ6vEopPemqZM/edit">豌豆荚文案风格指南</a>, by 豌豆荚</li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="https://github.com/sparanoid/chinese-copywriting-guidelines">中文文案排版指北</a>, by sparanoid</li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="http://w3c.github.io/clreq/">中文排版需求</a>, by W3C</li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="http://www.ruanyifeng.com/blog/2017/02/filename-should-be-lowercase.html">为什么文件名要小写？</a>, by 阮一峰</li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="https://developers.google.com/style/">Google Developer Documentation Style Guide</a>, by Google</li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="http://www.moe.gov.cn/ewebeditor/uploadfile/2015/01/13/20150113091154536.pdf">出版物上数字用法的规定（国家标准GBT15835－2011）</a></li>
<li><a target="_blank" rel="noopener external nofollow noreferrer" href="https://zh.wikisource.org/zh-hans/GB_3100-1993_%E5%9B%BD%E9%99%85%E5%8D%95%E4%BD%8D%E5%88%B6%E5%8F%8A%E5%85%B6%E5%BA%94%E7%94%A8">GB 3100-1993 国际单位制及其应用</a></li>
</ul>

            </div>
            <hr>
            <!-- 添加的代码 -->
            <div class="note note-success">本文到这就结束了，如果你对文章内容有什么疑问的话，可以在下面的评论区留言，我会及时地回复你！</div>
            <div>
              <div class="post-metas mb-3">
                
                  <div class="post-meta mr-3">
                    <i class="iconfont icon-category"></i>
                    
                      <a class="hover-with-bg" href="/categories/%E8%BD%AC%E8%BD%BD/">转载</a>
                    
                  </div>
                
                
                  <div class="post-meta">
                    <i class="iconfont icon-tags"></i>
                    
                      <a class="hover-with-bg" href="/tags/%E5%86%99%E4%BD%9C%E8%A7%84%E8%8C%83/">写作规范</a>
                    
                  </div>
                
              </div>
              
                <p class="note note-warning">
                  <strong>本文作者: </strong><a href="/">Guan Qing</a> <br>
                  <strong>本文链接: </strong><a href="https://jinghu-moon.top/posts/9113742/">https://jinghu-moon.top/posts/9113742/</a> <br>
                  <strong>版权声明: </strong>本博客所有文章除特别声明外，均采用 <i class="iconfont icon-cc"></i> <a target="_blank" href="https://creativecommons.org/licenses/by-sa/4.0/deed.zh" rel="nofollow noopener noopener">CC BY-SA 4.0 协议</a> ，转载请注明出处！
                    </p>
                    
              
                <div class="post-prevnext">
                  <article class="post-prev col-6">
                    
                    
                      <a href="/posts/3b8ba7c7/">
                        <i class="iconfont icon-arrowleft"></i>
                        <span class="hidden-mobile">text</span>
                        <span class="visible-mobile">上一篇</span>
                      </a>
                    
                  </article>
                  <article class="post-next col-6">
                    
                    
                      <a href="/posts/7c77eb1/">
                        <span class="hidden-mobile">文章名</span>
                        <span class="visible-mobile">下一篇</span>
                        <i class="iconfont icon-arrowright"></i>
                      </a>
                    
                  </article>
                </div>
              
            </div>

            
              <!-- Comments -->
              <article class="comments" id="comments" lazyload>
                
                  
                
                
  <div id="twikoo"></div>
  <script type="text/javascript">
    Fluid.utils.loadComments('#comments', function() {
      Fluid.utils.createScript('https://cdn.staticfile.org/twikoo/1.4.17/twikoo.all.min.js', function() {
        var options = Object.assign(
          {"envId":"https://twikoo-comment-phi.vercel.app/","region":"ap-shanghai","path":"window.location.pathname"},
          {
            el: '#twikoo',
            path: 'window.location.pathname',
            onCommentLoaded: function() {
              Fluid.plugins.initFancyBox('#twikoo .tk-content img:not(.tk-owo-emotion)');
            }
          }
        )
        twikoo.init(options)
      });
    });
  </script>
  <noscript>Please enable JavaScript to view the comments</noscript>


              </article>
            
          </article>
        </div>
      </div>
    </div>
    
      <div class="d-none d-lg-block col-lg-2 toc-container" id="toc-ctn">
        <div id="toc">
  <p class="toc-header"><i class="iconfont icon-list"></i>&nbsp;目录</p>
  <div class="toc-body" id="toc-body"></div>
</div>

      </div>
    
  </div>
</div>

<!-- Custom -->


    

    
      <a id="scroll-top-button" aria-label="TOP" href="#" role="button">
        <i class="iconfont icon-arrowup" aria-hidden="true"></i>
      </a>
    

    
      <div class="modal fade" id="modalSearch" tabindex="-1" role="dialog" aria-labelledby="ModalLabel"
     aria-hidden="true">
  <div class="modal-dialog modal-dialog-scrollable modal-lg" role="document">
    <div class="modal-content">
      <div class="modal-header text-center">
        <h4 class="modal-title w-100 font-weight-bold">搜索</h4>
        <button type="button" id="local-search-close" class="close" data-dismiss="modal" aria-label="Close">
          <span aria-hidden="true">&times;</span>
        </button>
      </div>
      <div class="modal-body mx-3">
        <div class="md-form mb-5">
          <input type="text" id="local-search-input" class="form-control validate">
          <label data-error="x" data-success="v"
                 for="local-search-input">关键词</label>
        </div>
        <div class="list-group" id="local-search-result"></div>
      </div>
    </div>
  </div>
</div>
    

    
      <div class="col-lg-7 mx-auto nopadding-x-md">
        <div class="container custom mx-auto">
          <div id="webpushr-subscription-button" data-size="medium" data-button-text="订阅通知" data-subscriber-count-text="名用户已订阅"></div>
        </div>
      </div>
    
  </main>

  <footer class="text-center mt-5 py-3">
  <div class="footer-content">
     <a href="https://hexo.io" target="_blank" rel="nofollow noopener"><span>Hexo</span></a> <i class="iconfont icon-love"></i> <a href="https://github.com/fluid-dev/hexo-theme-fluid" target="_blank" rel="nofollow noopener"><span>Fluid</span></a> 
  </div>
  
  <div class="statistics">
    
    

    
      
        <!-- 不蒜子统计PV -->
        <span id="busuanzi_container_site_pv" style="display: none">
            总访问量 
            <span id="busuanzi_value_site_pv"></span>
             次
          </span>
      
      
        <!-- 不蒜子统计UV -->
        <span id="busuanzi_container_site_uv" style="display: none">
            总访客数 
            <span id="busuanzi_value_site_uv"></span>
             人
          </span>
      
    
  </div>


  

  

  <!-- 添加代码1 今日诗词 -->
  <!-- ============================================================================================= -->
  <!-- <span id="jinrishici-sentence">正在加载今日诗词....</span>
<script src="https://sdk.jinrishici.com/v2/browser/jinrishici.js" charset="utf-8"></script> -->

  <!-- 添加代码2 今日诗词 -->
  <!-- <script src="https://sdk.jinrishici.com/v2/browser/jinrishici.js" charset="utf-8"></script>
  <text class="poem_sentence"></text>
  <text class="poem_info"></text>
  <script type="text/javascript">
    jinrishici.load(function (result) {
      var sentence = document.querySelector(".poem_sentence")
      var info = document.querySelector(".poem_info")
      sentence.innerHTML = result.data.content
      info.innerHTML = '— ' + result.data.origin.author
    });

  </script> -->
  <!-- ============================================================================================= -->
  <span class="post-count">本站已有 4.5k 字。</span>
  <!-- 一言 -->
  
  <div class="footer-hitokoto">
    <a id="hitokotoa" href="#" target="_blank" rel="nofollow noopener noreferrer">
      <span id="hitokoto"></span>
    </a>
  </div>
  
  <div id="google_translate_element"></div>

  <span style="font-size: .85rem;line-height: 2;"> 本网站由 <a href="https://www.upyun.com/?utm_source=lianmeng&utm_medium=referral" target="_blank"
    rel="nofollow noopener"><svg t="1645161659001" class="icon" viewBox="0 0 4442 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="1936" width="48" height="48"><path d="M1258.61548453-45.82215132c-22.90178928-22.90178928-52.34694652-39.26021062-81.79210521-52.34694651-22.90178928-13.08673737-49.07526254-6.54336796-62.16199844 13.0867359L937.99043601 150.47889885l-13.08673737 16.35842135c-19.63010531 26.17347327-49.07526254 39.26021062-81.79210375 39.26020915h-32.71684267c-91.60715713 3.27168397-179.94262883 49.07526254-235.56125933 124.32399983-45.80357857 58.89031445-65.43368387 134.13905173-65.43368387 206.11610208 0 13.08673737 9.81505191 26.17347327 22.90178927 29.44515724 26.17347327 13.08673737 42.5318946 35.98852518 45.80357858 65.43368389 9.81505191 42.5318946-19.63010531 85.06378772-62.16199992 94.87884112-45.80357857 13.08673737-91.60715713-13.08673737-104.69389303-55.61863049v-3.27168544c-6.54336796-26.17347327 0-49.07526254 16.35842134-68.70536641 9.81505191-9.81505191 13.08673737-26.17347327 13.08673588-39.2602106-6.54336796-94.87884111 19.63010531-193.02936621 78.52041977-268.27810202 71.97705183-94.87884111 183.21431429-153.76915557 304.26662868-153.76915558 22.90178928 0 42.5318946-13.08673737 55.61863049-29.44515871l163.58420897-215.93115401c9.81505191-13.08673737 6.54336796-32.71684119-6.54336794-42.5318946-3.27168397-3.27168397-6.54336796-3.27168397-9.81505341-6.54336942-274.82146994-81.79210375-579.08809861 16.35842133-755.75904346 251.91968214-238.83294478 310.80999662-179.94262883 755.75904348 130.86736775 994.59198826 29.44515724 19.63010531 62.16199991 42.5318946 91.60715569 62.16199844 19.63010531 9.81505191 45.80357857 6.54336796 62.16199991-13.0867359l176.67094484-238.83294478 13.08673738-16.35842133c19.63010531-26.17347327 49.07526254-39.26021062 81.79210375-39.26020915h35.98852517c91.60715713-3.27168397 179.94262883-49.07526254 232.28957684-124.32399836 45.80357857-58.89031445 68.70536787-134.13905173 65.43368388-206.11610357 0-13.08673737-9.81505191-26.17347327-19.6301053-29.44515721-26.17347327-13.08673737-45.80357857-35.98852518-45.80357858-65.43368391-9.81505191-42.5318946 16.35842133-85.06378772 62.16199991-94.87884111 45.80357857-13.08673737 91.60715713 13.08673737 104.69389305 55.61863196 3.27168397 26.17347327 0 49.07526254-19.63010533 68.70536639-9.81505191 9.81505191-13.08673737 26.17347327-13.0867359 39.26021064 9.81505191 94.87884111-19.63010531 189.75768224-75.24873727 268.27810199-71.97705183 94.87884111-183.21431429 153.76915557-304.26662718 153.7691556-22.90178928 0-42.5318946 13.08673737-55.61863049 29.44515868l-163.58420898 215.93115403c-9.81505191 13.08673737-6.54336796 32.71684119 6.54336795 42.53189458 3.27168397 3.27168397 6.54336796 3.27168397 9.81505339 6.54336797 284.63652335 85.06378772 588.90315054-16.35842133 765.5740954-255.19136465 219.20283948-314.08168058 157.04083955-755.75904348-153.76915559-994.59198826z m1171.26293314 193.02936622v-16.35842135c0-9.81505191-6.54336796-19.63010531-19.63010533-22.90178929H1850.79031903c-9.81505191 0-19.63010531 6.54336796-22.90178926 19.63010532v35.98852665c0 9.81505191 6.54336796 19.63010531 19.63010531 22.90178928h471.12252011c9.81505191 0 19.63010531 6.54336796 22.90178929 19.63010384v6.54336941c-26.17347327 150.49747162-88.33547317 291.1798913-186.48599678 408.96052171-3.27168397 9.81505191-16.35842133 9.81505191-26.17347325 0l-3.27168544-3.27168545c-75.2487358-98.1505251-127.59568233-209.38778755-153.7691556-330.44010044 0-13.08673737-13.08673737-16.35842133-26.17347325-16.35842136h-32.7168412c-13.08673737 0-22.90178928 13.08673737-19.63010532 26.17347327 29.44515724 137.41073571 88.33547317 268.27810202 176.67094488 379.51536445 9.81505191 9.81505191 9.81505191 22.90178928 0 29.44515724-94.87884111 91.60715713-212.65947151 157.04083955-343.52683781 179.94262885-13.08673737 0-16.35842133 13.08673737-16.35842136 22.9017893v32.71684266c0 13.08673737 13.08673737 22.90178928 26.17347326 22.90178929 147.22578764-26.17347327 284.63652335-94.87884111 392.60210184-202.8444196 6.54336796-9.81505191 19.63010531-9.81505191 29.44515723 0 94.87884111 91.60715713 209.38778755 160.312525 333.71178442 199.57273415 9.81505191 3.27168397 19.63010531 0 26.17347472-9.8150519v-3.27168399l9.81505192-32.7168412c3.27168397-9.81505191-3.27168397-22.90178928-13.08673735-26.17347325-114.50894643-35.98852518-219.20283948-98.1505251-304.26662719-179.94263031-9.81505191-9.81505191-9.81505191-22.90178928 0-29.44515725 127.59568233-153.76915557 206.1161021-336.98346986 219.20283947-533.28452003z m379.51536446-75.24873583h-32.71684268c-9.81505191 0-19.63010531 6.54336796-22.90178929 19.63010532v121.05231437c0 9.81505191-6.54336796 19.63010531-19.63010531 22.90178929h-81.79210375c-9.81505191 0-19.63010531 6.54336796-19.63010531 19.63010385v39.26021062c0 13.08673737 6.54336796 19.63010531 19.63010531 22.9017893h78.52041978c9.81505191 0 19.63010531 6.54336796 19.63010531 19.6301053v170.12757692c0 9.81505191-6.54336796 19.63010531-19.63010531 22.9017893h-81.79210376c-9.81505191 0-19.63010531 6.54336796-19.63010531 19.6301053v42.53189311c0 13.08673737 6.54336796 19.63010531 19.63010531 22.90178929h78.52041978c9.81505191 0 19.63010531 6.54336796 19.63010531 19.63010531v166.85589296c0 35.98852518-13.08673737 94.87884111-104.69389303 98.15052508-9.81505191 0-19.63010531 6.54336796-19.6301053 19.63010531v35.98852517c0 13.08673737 13.08673737 22.90178928 26.17347324 22.9017893 88.33547317-9.81505191 179.94262883-55.6186305 179.94262886-176.67094486v-163.58420898c0-9.81505191 6.54336796-19.63010531 19.6301053-19.63010531h71.97705184c13.08673737 0 19.63010531-9.81505191 19.6301053-19.63010385v-35.98852664c0-9.81505191-6.54336796-19.63010531-19.6301053-19.63010531h-65.43368391c-9.81505191 0-19.63010531-6.54336796-19.63010381-19.63010532V346.77994906c0-9.81505191 6.54336796-19.63010531 19.63010381-19.63010533h71.97705183c9.81505191 0 19.63010531-6.54336796 19.63010532-19.63010384v-35.98852667c0-9.81505191-6.54336796-19.63010531-19.63010532-22.90178926H2855.19735921c-9.81505191 0-19.63010531-6.54336796-19.63010381-19.63010533v-121.05231437c-3.27168397-26.17347327-13.08673737-35.98852518-26.17347327-35.98852519z m179.94262883 870.26798992c0 9.81505191 6.54336796 19.63010531 19.63010531 22.90178929h251.91968067c107.96557701 3.27168397 196.30105018-81.79210375 199.57273416-189.75768224v-523.46946813c0-9.81505191-6.54336796-19.63010531-19.63010532-19.63010381h-428.59062553c-9.81505191 0-19.63010531 6.54336796-19.63010531 19.63010381v3.27168399l-3.27168398 687.05367709z m268.27810201-55.61863196H3084.21525207c-13.08673737 0-19.63010531-6.54336796-22.90178927-19.63010385v-238.83294476c0-13.08673737 9.81505191-19.63010531 19.63010531-19.63010532h274.82146996c9.81505191 0 19.63010531 6.54336796 22.90178927 19.63010532v150.49747159c0 62.16199991-55.6186305 111.23726246-121.05231437 107.96557702 3.27168397 0 0 0 0 0z m121.05231437-559.4579933V510.36415802c0 9.81505191-6.54336796 19.63010531-19.6301053 22.90178928H3084.21525207c-13.08673737 0-19.63010531-6.54336796-22.90178927-19.63010532v-183.2143128c0-13.08673737 6.54336796-19.63010531 19.63010531-22.90178929h274.82146996c13.08673737-3.27168397 22.90178928 6.54336796 22.90178927 19.63010384 0-3.27168397 0 0 0 0z m-52.34694653-255.19136466h-219.20283944c-9.81505191 0-19.63010531 6.54336796-19.63010531 19.63010532v39.26020916c0 9.81505191 6.54336796 19.63010531 19.63010531 19.6301053h222.47452343c9.81505191 0 19.63010531-9.81505191 19.63010532-19.6301053v-35.98852518c0-9.81505191-9.81505191-19.63010531-22.90178931-22.9017893 3.27168397 0 0 0 0 0z m840.82283123 35.98852519h-454.7640988c-9.81505191 0-19.63010531 6.54336796-22.90178929 16.35842135v39.26021062c0 9.81505191 6.54336796 19.63010531 19.63010383 22.90178928h458.03578426c9.81505191 0 19.63010531-6.54336796 19.6301053-19.63010531v-35.98852665c3.27168397-9.81505191-3.27168397-19.63010531-13.0867359-22.90178929h-6.5433694z m-193.02936622 392.60210184h317.35336456c9.81505191 0 19.63010531-6.54336796 19.63010531-19.63010532V444.93047413c0-9.81505191-6.54336796-19.63010531-19.63010531-19.6301053h-706.68378093c-9.81505191 0-19.63010531 6.54336796-19.63010385 19.6301053v35.98852665c0 9.81505191 6.54336796 19.63010531 19.63010385 19.63010532h222.4745249c13.08673737 0 22.90178928 9.81505191 22.9017878 19.63010383 0 6.54336796 0 9.81505191-6.54336793 16.35842133l-147.22578764 261.73473406c-3.27168397 3.27168397-6.54336796 9.81505191-9.81505192 16.35841987-13.08673737 35.98852518-6.54336796 75.2487358 16.35841988 104.69389451 22.90178928 35.98852518 62.16199991 55.6186305 104.6938945 52.34694653h395.87378433c16.35842133 0 35.98852518-9.81505191 42.53189459-26.17347327 6.54336796-16.35842133 9.81505191-32.71684119 3.27168398-45.80357857l-91.60715714-186.48599826c-3.27168397-9.81505191-13.08673737-16.35842133-22.9017893-13.08673588-3.27168397 0-6.54336796 3.27168397-6.54336793 3.27168396l-29.44515725 16.35842134c-9.81505191 3.27168397-16.35842133 13.08673737-13.08673735 22.90178782 0 3.27168397 3.27168397 6.54336796 3.27168398 9.81505341l55.61863197 104.69389302c9.81505191 13.08673737-3.27168397 29.44515724-22.90178931 29.44515723h-317.35336454c-16.35842133 0-29.44515724-6.54336796-39.26021063-16.35841987-6.54336796-9.81505191-6.54336796-19.63010531-3.27168397-29.44515725 0-3.27168397 0-3.27168397 3.27168397-3.27168542l176.67094487-307.53831115c13.08673737-19.63010531 32.71684119-29.44515724 52.34694651-29.44515724z" fill="#00a0ff" p-id="1937"></path></svg>
  </a>提供 CDN 加速 / 云存储服务</span>
<script async src="/translate-google.js"></script>

<script type="text/javascript">
    function googleTranslateElementInit(){
        new google.translate.TranslateElement({
            pageLanguage: 'zh-CN',
            includedLanguages: 'af,ga,sq,it,ar,ja,az,kn,eu,ko,bn,la,be,lv,bg,lt,ca,mk,zh-CN,ms,zh-TW,mt,hr,no,cs,fa,da,pl,nl,pt,en,ro,eo,ru,et,sr,tl,sk,fi,sl,fr,es,gl,sw,ka,sv,de,ta,el,te,gu,th,ht,tr,iw,uk,hi,ur,hu,vi,is,cy,id,yi',
            autoDisplay:false
        },'google_translate_element');
    }
</script>

</footer>


  <!-- SCRIPTS -->
  
  <script  src="https://cdn.staticfile.org/nprogress/0.2.0/nprogress.min.js" ></script>
  <link  rel="stylesheet" href="https://cdn.staticfile.org/nprogress/0.2.0/nprogress.min.css" />

  <script>
    NProgress.configure({"showSpinner":false,"trickleSpeed":100})
    NProgress.start()
    window.addEventListener('load', function() {
      NProgress.done();
    })
  </script>


<script  src="https://cdn.staticfile.org/jquery/3.6.0/jquery.min.js" ></script>
<script  src="https://cdn.staticfile.org/twitter-bootstrap/4.6.1/js/bootstrap.min.js" ></script>
<script  src="/js/events.js" ></script>
<script  src="/js/plugins.js" ></script>

<script type="text/javascript">
  /*一言API*/
  $(document).ready(function () {
    getHitokoto();
  });

  function hitokoto(e) {
    $("#hitokoto").stop().fadeOut(function () {
      $("#hitokoto").html(e.hitokoto);
      var element = document.getElementById('hitokotoa');
      element.href = "https://hitokoto.cn/?uuid=" + e.uuid;
      $("#hitokoto").stop().fadeIn()
    })
  };

  function getHitokoto() {
    var e = ["d", "e", "h", "k"];
    // 返回句子类型 https://developer.hitokoto.cn/sentence/#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0
    fetch('https://v1.hitokoto.cn/?encode=json&charset=utf-8&c=' + e[Math.floor(Math.random() * e.length)], {
      cache: 'no-cache',
      method: 'GET',
      mode: 'cors'
    }).then(
      response => response.json()
    ).then(
      data => {
        hitokoto(data)
        setTimeout(getHitokoto, 8000) //再次获取 hitokoto 时间，时间单位是毫秒
      }
    ).catch(
      console.error
    )
  };

</script>

 <!-- 添加的代码 -->
<!-- Plugins -->


  <script  src="/js/local-search.js" ></script>



  
    <script  src="/js/img-lazyload.js" ></script>
  



  



  
    <script  src="https://cdn.staticfile.org/tocbot/4.18.0/tocbot.min.js" ></script>
  
  
    <script  src="https://cdn.staticfile.org/fancybox/3.5.7/jquery.fancybox.min.js" ></script>
  
  
    <script  src="https://cdn.staticfile.org/anchor-js/4.3.1/anchor.min.js" ></script>
  
  
    <script defer src="https://cdn.staticfile.org/clipboard.js/2.0.10/clipboard.min.js" ></script>
  



  <script defer src="https://busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js" ></script>



 <script  src="https://cdn.staticfile.org/typed.js/2.0.12/typed.min.js" ></script>
<script
  src="https://sdk.jinrishici.com/v2/browser/jinrishici.js"
  charset="utf-8"
></script>

<script>
  function typing(id, title){
      var typed = new Typed('#' + id, {
          strings: [
            '  ',
            title + "&nbsp;",
          ],
          cursorChar: "_",
          typeSpeed: 70,
          loop: false,
      });
      typed.stop();
      $(document).ready(function () {
          $(".typed-cursor").addClass("h2");
          typed.start();
      });
  }

// 判断函数
  
      typing("subtitle", "中文技术文档写作规范") // 打印文章标题
  
</script>

<!-- 注意，不能用代码格式化插件格式化代码 -->
<!-- typing("hitokoto", data.hitokoto + '<br /> <h5>' + '——' + data.from + '</h5>')
typing("hitokoto", '『' + data.hitokoto + '』' + '<br /> <h5>'+ '——' + '「' + data.from + '」' + '</h5>') -->




  

  
    <!-- KaTeX -->
    <link  rel="stylesheet" href="https://cdn.staticfile.org/KaTeX/0.15.2/katex.min.css" />
  










  
<script src="//at.alicdn.com/t/font_2976433_iqbfcetntd.js"></script>
<script src="/js/code-folding.js"></script>
<script src="/js/code-folding-not-linenumber.js"></script>
<script src="/js/translate-google.js"></script>
<script src="/js/Memory-browsing-position.js"></script>
<script src="/js/stars.js"></script>



  <script type="text/javascript">
    /*窗口监视*/
    var originalTitle = document.title;
    window.onblur = function(){document.title = "Guan Qing 的博客"};
    window.onfocus = function(){document.title = originalTitle};
  </script>

<!-- 主题的启动项 保持在最底部 -->
<script  src="/js/boot.js" ></script>

  <!-- <script type="text/javascript">
    var OriginTitile = document.title,
        st;
    document.addEventListener("visibilitychange", function () {
        document.hidden ? (document.title = "Guan Qing 的个人博客", clearTimeout(st)) : (document.title = OriginTitile)
    })
  </script> -->

</body>
</html>

<!-- 注意，不能用代码格式化插件格式化代码 -->